Dokumentation
Konfiguration
Das Modul HD Ringtones kann mehrfach instanziiert werden, um unterschiedliche Klingeltöne für verschiedene Konfigurationen zu setzen. Wird das Modul mehrfach instanziiert, muss jede Instanz mit einem gültigen Modullizenzschlüssel versehen werden. Instanzen ohne Lizenzschlüssel sind funktionslos.
Bei der Verwendung mehrerer Modulkonfigurationen/Instanzen muss sichergestellt sein, dass diese nicht für dieselbe Anrufkonfiguration angewendet wird. Andernfalls können mehrfache Klingelton-Hinweise im Anruf eingebettet werden, was dazu führen kann, dass kein individueller Klingelton abgespielt wird.
Die Auswahl zwischen leisen und lauten Klingeltönen erfolgt über die Checkbox "Klingelton für laute Umgebungen" (bis Modulversion v20200209). Weitere Lautstärkeeinstellung müssen direkt am Endgerät vorgenommen werden.
Bitte stellen Sie sicher, dass das erste Netzwerkinterface der STARFACE mit einer statischen IP-Adresse versehen ist, die von den Endgeräten per HTTP erreicht werden kann.
Besonderheit bei STARFACE-Cloud ohne statische IP-Adresse sowie STARFACE 7.x
Neuere STARFACE-Cloud-Instanzen erhalten standardmäßig eine IP-Adresse aus einem privaten Subnetz, weshalb Klingeltöne darüber nicht abgerufen werden können. Es ist deshalb zwingend notwendig, den Hostnamen (z.B. meinefirma.starface-cloud.com) in den Erweiterten Einstellungen des Moduls, in das Feld STARFACE IP-Adresse einzutragen:
Selbiges gilt für STARFACE Versionen 7.x: Hier ist die für Endgeräte erreichbare IP-Adresse der STARFACE einzutragen.
Individuelle SIP-Header: Alert-Info (z.B. für Endgeräte-Klingeltöne), Call-Info (z.B. für Avatar-Bilder)
Seit Version 20190320 unterstützt HD Ringtones das Hinzufügen eigener SIP-Header zu Anrufen, die den definierten Regelwerken entsprechen.
Vorausgesetzt, das Endgerät unterstützt diese Funktion, können damit gerätesepezifische Klingeltöne oder auch Anruferbilder konfiguriert werden. HD Ringtones ermöglicht die allgemeine Konfiguration von SIP-Header-Einträgen, kann diese jedoch nicht validieren. Ob und wie ein Endgerät auf bestimmte SIP-Header reagiert, hängt vom Hersteller, Modell und der verwendeten Endgerätefirmware ab.
Die SIP-Header-Konfiguration dient der Umsetzung projektspezifischer Anforderungen und gehört nicht zum offiziell unterstützten Funktionsumfang dieses Moduls. Änderungen in diesem Bereich können erhebliche Auswirkungen auf die Telefonie haben – bis hin zum vollständigen Ausfall – und sollten daher nur von fachkundigem Personal vorgenommen werden. Support in Bezug auf die folgenden Funktionen ist explizit ausgeschlossen.
Um eigene SIP-Headereinträge konfigurieren zu können, aktivieren Sie bitte die Checkbox "Ich habe verstanden" und fügen die gewünschten Headereinträge hinzu.
Weiterführende Informationen konkreter Endgerätehersteller:
Bitte beachten Sie, dass bei Anrufen, die durch die iQueue-Warteschlange an Agenten signalisiert werden, nur von STARFACE explizit zugelassene SIP-Header übermittelt werden und es daher Einschränkungen bei der Verwendung individueller SIP-Header gibt. Welche Header gesetzt und an Agenten signalisiert werden können, liegt außerhalb unseres Einflussbereichs.
Gigaset N870 / STARFACE-Autoprovisionierung
Durch die STARFACE Autoprovisionierung der N870 wird die Fähigkeit Klingeltöne abzuspielen, standardmäßig deaktiviert. Die folgende Anpassung muß umgesetzt werden und nach jedem STARFACE-Update wiederholt werden, wenn Klingeltöne mit der N870 unterstützt werden sollen:
- Per SSH als root-Benutzer mit der STARFACE verbinden.
cd /opt/tomcat/webapps/localhost/starface/WEB-INF/filetemplates/gigasetConfig/n870/Die Datei template.xml (mittels einem Editor wie vim) ändern: Ändern Sie den Parameter SupportSipRingtones von 0 auf 1:
param name="DmGlobal.0.SupportSipRingtones" value="0"/wird zu
param name="DmGlobal.0.SupportSipRingtones" value="1"/- Speichern Sie die Datei.
Öffnen Sie das Webinterface der N870 und lösen Sie unter System/Provisionierung eine erneute Autoprovisionierung aus.
Zur Signalisierung externer Anrufe fügen Sie im Modul HD Ringtones folgenden SIP-Header-Eintrag hinzu:
SIP-Header: Alert-Info
Wert: www.notused.com; info=alert-external
Einschränkungen
Individuelle Klingeltöne für Anrufe auf iQueue-Warteschlangen können erst ab STARFACE Version 6.5 gesetzt werden, da die iQueue zu Agenten jeweils neue, nicht vom Modul modifizierbare Anrufe aufbaut. Aus diesem Grund werden in iQueues auch keine individuellen SIP-Header unterstützt. Funktionseinschränkungen bestehen außerdem, wenn ein eingehender Anruf mit Hilfe eines Moduls weitergeleitet wird, das die Weiterleitung durch den Aufbau eines neuen Gesprächs umsetzt.
Der Klingelton wird den Endgeräten als Download-URL (per HTTP über Port 50080/TCP) im SIP-Header bereitgestellt. Hierfür wird die IP-Adresse des ersten Netzwerkinterfaces der STARFACE verwendet. Ist diese IP-Adresse für ein Endgerät nicht erreichbar, ist kein Klingeltondownload möglich. Bei Betrieb von Endgeräten/UCC-Clients und STARFACE in unterschiedlichen Subnetzen muß sichergestellt sein, dass der Client zuverlässig und erfolgreich den Port 50080/TCP der STARFACE per HTTP erreichen kann.
Werden Endgeräte anderer Hersteller als Yealink/Tiptel eingesetzt, kann es beim Abspielen der Klingeltöne auf diesen Endgeräten zu Verzerrungen kommen.
Die absolute Lautstärke der Klingeltöne ist abhängig von der konfigurierten Klingeltonlautstärke am Endgerät. Das Modul kann diese nicht ändern.
Bei Verwendung der neuen STARFACE App (die STARFACE Client Anwendung ab Version STARFACE 8; Nachfolger des UCC Clients v 7.3) werden STARFACE-seitig konfigurierte Klingeltöne nicht abgespielt. Die STARFACE App verwendet ausschließlich die innerhalb der Anwendung ausgewählten Klingeltöne.